home *** CD-ROM | disk | FTP | other *** search
/ Shareware Grab Bag / Shareware Grab Bag.iso / 005 / pal15.arc / PAL.DOC < prev    next >
Encoding:
Text File  |  1986-12-10  |  44.1 KB  |  1,065 lines

  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.                                  INTRODUCTION TO
  12.  
  13.                             THE SHAREWARE VERSIONS OF
  14.  
  15.                                        PAL
  16.  
  17.                   the Personal Appointment Locator for SideKick
  18.  
  19.                                        and
  20.  
  21.                                   PALARM/PALSET
  22.  
  23.  
  24.  
  25.  
  26.  
  27.                         Copyright 1986 by PAL Software NY
  28.  
  29.                                All rights reserved
  30.  
  31.                                  PAL Software NY
  32.                                     Suite 12B
  33.                                  110 Greene St.
  34.                             New York, New York 10012
  35.                              Voice:   (212) 334-9172
  36.                               BBS:  (212) 334-9171
  37.  
  38.  
  39.  
  40.  
  41.  
  42.  
  43.             PAL, PALARM and PALSET are trademarks of PAL Software NY
  44.  
  45.                 SideKick is a trademark of Borland International
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.                                 Table of Contents
  56.  
  57.           Introduction . . . . . . . . . . . . . . . . . . . . . .    4
  58.  
  59.           Installation . . . . . . . . . . . . . . . . . . . . . .    5
  60.                     HARD DISK SYSTEMS: . . . . . . . . . . . . . .    5
  61.                     FLOPPY DISK SYSTEMS: . . . . . . . . . . . . .    5
  62.                     INSTALLING PALARM: . . . . . . . . . . . . . .    5
  63.                     USING PALSET:  . . . . . . . . . . . . . . . .    6
  64.                     CUSTOMIZATION: . . . . . . . . . . . . . . . .    6
  65.  
  66.           Menu Operation of PAL  . . . . . . . . . . . . . . . . .    7
  67.  
  68.           Command Line and Batch Operation of PAL  . . . . . . . .    7
  69.  
  70.           Help Online  . . . . . . . . . . . . . . . . . . . . . .    7
  71.  
  72.           Report Mode  . . . . . . . . . . . . . . . . . . . . . .    8
  73.                     REPORT MODE SYNTAX:  . . . . . . . . . . . . .    8
  74.                     DATE CONTROL:  . . . . . . . . . . . . . . . .    8
  75.                     TOGGLE SWITCHES: . . . . . . . . . . . . . . .    8
  76.                     FILE HANDLING: . . . . . . . . . . . . . . . .    9
  77.                     EXAMPLES:  . . . . . . . . . . . . . . . . . .    9
  78.                     SPECIAL MEMOS: . . . . . . . . . . . . . . . .   10
  79.  
  80.           Search Mode  . . . . . . . . . . . . . . . . . . . . . .   11
  81.                     SEARCH MODE SYNTAX:  . . . . . . . . . . . . .   11
  82.                     SEARCH MODE PARAMETERS:  . . . . . . . . . . .   11
  83.  
  84.           Reminders and Auto-Repeat Appointments . . . . . . . . .   12
  85.                     REMINDERS: . . . . . . . . . . . . . . . . . .   12
  86.                     AUTO-REPEAT APPOINTMENTS:  . . . . . . . . . .   12
  87.  
  88.           Garbage Collection . . . . . . . . . . . . . . . . . . .   13
  89.  
  90.           Multiple Appointment Files . . . . . . . . . . . . . . .   13
  91.  
  92.           Cloning New Versions of PAL to Your Specifications . . .   14
  93.                     COLOR: . . . . . . . . . . . . . . . . . . . .   14
  94.                     FILE HANDLING: . . . . . . . . . . . . . . . .   14
  95.                     PRINTER: . . . . . . . . . . . . . . . . . . .   14
  96.                     COMMAND LINE ACTION: . . . . . . . . . . . . .   15
  97.                     CREATING NEW COM FILES:  . . . . . . . . . . .   15
  98.                     RESTORING DISTRIBUTION DEFAULTS: . . . . . . .   15
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.           Alarms:  Using PALARM and PALSET . . . . . . . . . . . .   16
  106.                     KILLING AND SNOOZING:  . . . . . . . . . . . .   16
  107.                     CHANGING SNOOZE PERIODS: . . . . . . . . . . .   16
  108.                     CHANGING SOUND LEVEL:  . . . . . . . . . . . .   16
  109.                     CHANGING TIME AND DATE DISPLAY:  . . . . . . .   16
  110.                     EDITING ALARMS WITH PALSET:  . . . . . . . . .   17
  111.                     REMOVING PALARM: . . . . . . . . . . . . . . .   17
  112.                     CUSTOMIZING THE HOT KEY: . . . . . . . . . . .   18
  113.                     SCAN CODE TABLE: . . . . . . . . . . . . . . .   19
  114.  
  115.           Infinite Alarms with SideKick  . . . . . . . . . . . . .   20
  116.                     CREATING ALARMS WITH SK: . . . . . . . . . . .   20
  117.                     ADVANCE ALARMS:  . . . . . . . . . . . . . . .   20
  118.                     RUN PAL TO UPDATE ALARMS!  . . . . . . . . . .   21
  119.                     MANUAL SETTING VS. AUTOMATIC SETTING:  . . . .   21
  120.                     SHAREWARE LIMITATION:  . . . . . . . . . . . .   22
  121.  
  122.           TSR Wars; Multitasking . . . . . . . . . . . . . . . . .   22
  123.  
  124.           Support (Both Ways)  . . . . . . . . . . . . . . . . . .   24
  125.                     FOR YOU: . . . . . . . . . . . . . . . . . . .   24
  126.                     FROM YOU:  . . . . . . . . . . . . . . . . . .   24
  127.  
  128.           Commercial PAL . . . . . . . . . . . . . . . . . . . . .   24
  129.  
  130.           Legal Stuff:  Warranties and Limitations . . . . . . . .   25
  131.  
  132.  
  133.  
  134.  
  135.  
  136.  
  137.           Intro to PAL and PALARM/PALSET                      --  4  --
  138.  
  139.  
  140.           Introduction
  141.  
  142.                PAL is  a utility  for IBM-PC  and compatible owners who
  143.           use SideKick.  PAL  enhances SideKick's  appointment calendar
  144.           feature.   If you would like a quick demonstration of some of
  145.           PAL's features, then run the  batch  file  PALDEMO.BAT.   The
  146.           version of PAL described in this introduction is 1.5.
  147.  
  148.                PALARM is  a resident  alarm which is usable on IBM-PC's
  149.           and compatibles, regardless whether you use  SideKick or PAL.
  150.           The version  of PALARM described in this introduction is 1.1.
  151.  
  152.                PALSET is PALARM's non-resident companion which  is used
  153.           to  edit  alarms  and  set  PALARM's  various  features.  The
  154.           version of PALSET described in this introduction is 1.1.
  155.  
  156.                The shareware  versions described  in this documentation
  157.           have all  the same  features as  the commercial versions, but
  158.           with one important distinction.   The  full implementation of
  159.           the  ability  to  set  infinite alarms with SideKick has been
  160.           limited in time.  Until the end of June, 1987,  the shareware
  161.           versions will operate identically to the commercial versions,
  162.           so that  you can  determine whether  you like  the full alarm
  163.           feature  enough  to  purchase  the commercial version.  After
  164.           June, 1987, the shareware  versions will  no longer automati-
  165.           cally  interpret  alarms  set  with  SideKick,  and your only
  166.           method of setting  alarms  will  be  the  manual  method with
  167.           PALSET.  We hope that this extended demonstration period will
  168.           encourage you to purchase the commercial versions.
  169.  
  170.                This introduction should be  sufficient to  get you well
  171.           on your  way to exploiting all that PAL and PALARM can do for
  172.           you.  PAL also has online help, which is available  to you by
  173.           choosing the  help selection  from PAL's opening menu, or you
  174.           can bypass the opening menu by typing "PAL  HELP" at  the DOS
  175.           command line.  Online help for PALARM and PALSET is available
  176.           from the opening menu of PALSET.  
  177.  
  178.  
  179.  
  180.  
  181.  
  182.  
  183.  
  184.  
  185.  
  186.  
  187.           Intro to PAL and PALARM/PALSET                      --  5  --
  188.  
  189.  
  190.           Installation
  191.  
  192.                HARD DISK SYSTEMS:
  193.  
  194.                To use  PAL in  a hard  disk system,  copy the following
  195.           files to a single subdirectory which resides in your PATH (if
  196.           you aren't familiar with  paths,  check  your  DOS documenta-
  197.           tion):
  198.  
  199.                     PAL.COM
  200.                     PAL15.000
  201.                     PAL15.001
  202.                     PAL15.HLP
  203.  
  204.           The PAL15.HLP  file is  optional and is necessary only if you
  205.           want online help.   Invoke PAL  by issuing  the command "PAL"
  206.           from the  DOS command line.  So long as you have properly set
  207.           your PATH, it will not matter what your  current directory is
  208.           when you invoke PAL.
  209.  
  210.                FLOPPY DISK SYSTEMS:
  211.  
  212.                To use  PAL in  a floppy  disk system, copy the four PAL
  213.           files mentioned above to a single disk, preferably the one on
  214.           which  you  keep  your  SideKick appointment file.  If you're
  215.           short on space, you  may want  to delete  the PAL15.HLP file,
  216.           but doing so will disable the online help feature.  Make sure
  217.           that the disk containing PAL is in the current drive, or else
  218.           that  you  have  set  your  DOS  PATH  to look in that drive.
  219.           Invoke PAL by issuing the command "PAL" from  the DOS command
  220.           line.  
  221.  
  222.                INSTALLING PALARM:
  223.  
  224.                To  use  PALARM,  simply  type  the  program name at the
  225.           command line  and  hit  the  carriage  return.    PALARM then
  226.           installs itself and remains resident in memory.  You will not
  227.           have any further need of "PALARM.COM" until the next time you
  228.           boot.    PALARM  must  be  installed  prior  to the time that
  229.           SideKick installs itself, so if you intend to use it regular-
  230.           ly, place  the PALARM command in your AUTOEXEC.BAT file prior
  231.           to the SK command.  PALARM will cause your computer to pop up
  232.  
  233.  
  234.  
  235.  
  236.  
  237.           Intro to PAL and PALARM/PALSET                      --  6  --
  238.  
  239.  
  240.           with  a  visual  and  audible  alarm  which you have set with
  241.           either PALSET or SideKick.
  242.  
  243.                USING PALSET:
  244.  
  245.                To  use  PALSET,  you  must  COPY  both  PALSET.COM  and
  246.           PALSET.000 into  a single  subdirectory which resides in your
  247.           PATH.  PALSET, like PALARM, is  called from  the command line
  248.           without  additional  parameters.    PALSET  will  not operate
  249.           unless PALARM is already loaded.
  250.  
  251.                CUSTOMIZATION:
  252.  
  253.                You may  customize  many  of  the  features  of  PAL and
  254.           PALARM.    These  customization  features  are  described  in
  255.           greater detail later in this documentation.
  256.  
  257.                To customize PAL, select "CLONE" from the main  menu, or
  258.           invoke "PAL CLONE" from the command line.
  259.  
  260.                To  customize  PALARM,  invoke  PALSET, then select "IN-
  261.           STALL" from the main menu.
  262.  
  263.  
  264.  
  265.  
  266.  
  267.  
  268.  
  269.  
  270.           Intro to PAL and PALARM/PALSET                      --  7  --
  271.  
  272.  
  273.           Menu Operation of PAL
  274.  
  275.                PAL is distributed so that  if  you  invoke  the program
  276.           without  any  additional  command  line  parameters,  it will
  277.           present you  with a  menu to  choose from  its various opera-
  278.           tions.  To select an operation, hit the alphabetic or numeric
  279.           key which is associated  with  the  operation  you  desire to
  280.           activate.  No carriage return is required.  
  281.  
  282.  
  283.           Command Line and Batch Operation of PAL
  284.  
  285.                Alternatively,  you  may  invoke any of PAL's operations
  286.           directly from the DOS command line by adding parameters after
  287.           the  program  name.    Command  line  operation is especially
  288.           useful for batch files.
  289.  
  290.                Command line  operation  is  explained  in  detail below
  291.           under the headings of "Report Mode" and "Search Mode".
  292.  
  293.  
  294.           Help Online 
  295.  
  296.                You can  invoke online  help from the beginning menu, or
  297.           directly from the command line with "PAL HELP".  To  select a
  298.           subject for  help, hit the alphabetic key which is associated
  299.           with the subject which  you  wish  to  review.    No carriage
  300.           return is required.
  301.  
  302.  
  303.  
  304.  
  305.  
  306.  
  307.  
  308.  
  309.           Intro to PAL and PALARM/PALSET                      --  8  --
  310.  
  311.  
  312.           Report Mode
  313.  
  314.                REPORT MODE SYNTAX:
  315.  
  316.                Syntax for the Report Mode is:
  317.  
  318.                     PAL [@mm/dd/yyyy] n[ACFP] [FILENAME]
  319.  
  320.           The only required entries on the command line are the program
  321.           name and "n", where "n" is the number of days  you would like
  322.           the  report  to  encompass.    The  remaining  parameters are
  323.           optional.  Do not type in  the brackets;  they are  set forth
  324.           above only to indicate that the items are optional.  
  325.  
  326.                DATE CONTROL:
  327.  
  328.                The first optional parameter is to set the start date of
  329.           the report at other  than  your  present  system  date.   For
  330.           instance, "PAL  @1/1/87 7" will give you appointments for the
  331.           first week in 1987.  If you use the "@"  by itself  without a
  332.           following date, then PAL will assume you mean "@1/1/85"; this
  333.           is useful if you want a shorthand method to begin a Report or
  334.           Search from a very early date.
  335.  
  336.                TOGGLE SWITCHES:
  337.  
  338.                The  second  group  of  optional parameters ("ACFP") are
  339.           toggle switches.  They must be  specified immediately follow-
  340.           ing "n", without intervening spaces.  They stand for:
  341.  
  342.                     *    disabling the "A"larm updating function, 
  343.  
  344.                     *    "C"olor toggle, 
  345.  
  346.                     *    send report to "F"ile, and 
  347.  
  348.                     *    send report to "P"rinter.  
  349.  
  350.  
  351.  
  352.  
  353.  
  354.  
  355.           Intro to PAL and PALARM/PALSET                      --  9  --
  356.  
  357.  
  358.                FILE HANDLING:
  359.  
  360.                The last  optional parameter  permits you to specify the
  361.           complete name, including drive and  path  if  needed,  of the
  362.           file  you  desire  to  search.    If  you  do not specify the
  363.           filename, then PAL will use its  default assumptions  for the
  364.           name and  location of  the file.  You may freely change those
  365.           assumptions (among others) with PAL's cloning procedure.
  366.  
  367.                PAL  makes  its  own  assumptions  as  to  the  name and
  368.           location  of  your  appointment  file.   On distribution, PAL
  369.           assumes that the name of the file to examine is "APPOINT.APP"
  370.           and looks  for it  first in  the current directory from which
  371.           PAL was invoked.   If PAL  does not  find APPOINT.APP  in the
  372.           current  directory  it  looks  for  it in "C:\SK" and then in
  373.           "C:\".  If PAL's assumptions as to the  name and  location of
  374.           your  appointment  file  are  incorrect,  then you may either
  375.           change PAL's assumptions with  the clone  feature, change the
  376.           name and  location of your appointment file in order to match
  377.           PAL's  assumptions,  or  else  fully  specify  the  name  and
  378.           location each  time you  invoke PAL.   You will probably find
  379.           the cloning option to be the most effective choice.
  380.  
  381.                EXAMPLES:
  382.  
  383.                As an example of Report Mode,  to see  all your appoint-
  384.           ments for  the next  week, issue the command "PAL 7".  A very
  385.           common use for PAL is to  insert such  a command  as the last
  386.           line of  your AUTOEXEC.BAT file, so that your coming appoint-
  387.           ments greet you when  your computer  finishes booting  in the
  388.           morning.
  389.  
  390.  
  391.  
  392.  
  393.  
  394.  
  395.           Intro to PAL and PALARM/PALSET                     --  10  --
  396.  
  397.  
  398.                SPECIAL MEMOS:
  399.  
  400.                In Report Mode, PAL will interpret some of your memos as
  401.           having special  meaning  and  will  provide  you  with extra-
  402.           special results when those memos are encountered.  They are:
  403.  
  404.                     *    Reminders:     Memos containing "!"
  405.  
  406.                     *    Alarms:        Memos containing "@"
  407.  
  408.                     *    Auto-Repeat:   Memos containing "[" or "]"
  409.  
  410.           See below for a further explanation of these special memos.
  411.  
  412.  
  413.  
  414.  
  415.  
  416.  
  417.  
  418.  
  419.           Intro to PAL and PALARM/PALSET                     --  11  --
  420.  
  421.  
  422.           Search Mode
  423.  
  424.                SEARCH MODE SYNTAX:
  425.  
  426.                Syntax for the Search Mode is:
  427.  
  428.                     PAL [@mm/dd/yyyy] $[ACFP] SEARCHTERM [FILENAME]
  429.  
  430.           The  required  parameters  in  Search  Mode are the program's
  431.           name, followed by the "$" character  (think $earch), followed
  432.           by the term that you want PAL to search for; the term must be
  433.           a single word or part of a word, without intervening spaces. 
  434.  
  435.                SEARCH MODE PARAMETERS:
  436.  
  437.                The optional parameters are identical to those permitted
  438.           in Report  Mode.   The "A" switch for disabling alarms is not
  439.           significant in Search Mode, since PAL will not  update alarms
  440.           when you are operating in Search Mode.  Alarms, reminders and
  441.           auto-repeat appointments will  not  be  treated  specially in
  442.           Search  Mode,  for  Search  Mode is restricted to the single,
  443.           simple function of conducting a search through your file.
  444.  
  445.                For instance, if you issue the command "PAL $ den", then
  446.           PAL will show you all upcoming appointments which contain the
  447.           characters "den", such  as  "Dentist  appointment"  or "lunch
  448.           with Denise".
  449.  
  450.  
  451.  
  452.  
  453.  
  454.  
  455.  
  456.  
  457.           Intro to PAL and PALARM/PALSET                     --  12  --
  458.  
  459.  
  460.           Reminders and Auto-Repeat Appointments
  461.  
  462.                Special features  of PAL include the ability to maintain
  463.           a reminder list and automatically repeating appointments.
  464.  
  465.                REMINDERS:
  466.  
  467.                If you want to maintain a  reminder list,  then enter an
  468.           appointment  with  SideKick  and  insert an exclamation point
  469.           ("!") anywhere in the memo.  If the  day passes  and the memo
  470.           is still  there, then  PAL will  remind you of that memo in a
  471.           special section of its report.
  472.  
  473.                AUTO-REPEAT APPOINTMENTS:
  474.  
  475.                If you want to have an appointment come  up periodically
  476.           on a  monthly or  annual basis,  then insert the left bracket
  477.           ("[")  for  an  annual  auto-repeat  appointment  or  a right
  478.           bracket ("]")  for a monthly auto-repeat appointment.  You'll
  479.           never forget that birthday again!
  480.  
  481.  
  482.  
  483.  
  484.  
  485.  
  486.  
  487.  
  488.           Intro to PAL and PALARM/PALSET                     --  13  --
  489.  
  490.  
  491.           Garbage Collection
  492.  
  493.                If you'd like to delete all your old  appointments, then
  494.           invoke the  delete function with "PAL DELETE".  This will get
  495.           rid of all your out of date appointments except for reminders
  496.           ("!") and auto-repeat appointments ("[" or "]").  Optionally,
  497.           you may instruct PAL to get rid of the old reminders as well.
  498.           This function  will also  get rid  of some useless records in
  499.           your appointment file which  SideKick  tends  to  leave there
  500.           even after  you delete them with SideKick; if all you want to
  501.           do is collect and dispose of the garbage  but leave  your old
  502.           visible  appointments  intact,  then  use  the  command  "PAL
  503.           PURGE".
  504.  
  505.  
  506.           Multiple Appointment Files
  507.  
  508.                If you keep more than  one  appointment  file  and would
  509.           like to  view them  together to  check on conflicts or common
  510.           free time, then copy  them together  (using the  "/b" parame-
  511.           ter), and  view the combined file with PAL.  For instance, if
  512.           Dick uses DICK.APP  and  Jane  uses  JANE.APP,  then  use the
  513.           following command to combine the files into TOTAL.APP:
  514.  
  515.                     COPY DICK.APP + JANE.APP TOTAL.APP /b
  516.  
  517.           Then use PAL on the combined file:
  518.  
  519.                     PAL 7 TOTAL.APP
  520.  
  521.  
  522.  
  523.  
  524.  
  525.  
  526.  
  527.  
  528.           Intro to PAL and PALARM/PALSET                     --  14  --
  529.  
  530.  
  531.           Cloning New Versions of PAL to Your Specifications
  532.  
  533.                If you  want to  teach PAL  the name  of the appointment
  534.           file it should use and where  to  find  it,  or  you  want to
  535.           change any  of the  assumptions that  PAL makes, then use the
  536.           CLONE procedure.
  537.  
  538.                Enter the CLONE procedure from the main menu or from the
  539.           DOS command line with the command "PAL CLONE".
  540.  
  541.                COLOR:
  542.  
  543.                There  are  many  changes  you  can  make with the CLONE
  544.           procedure, which you can  discover  through  exploring.   For
  545.           instance, you  can turn PAL's color on or off permanently for
  546.           color monitors instead of using the "C" toggle on the command
  547.           line.  Once you set color on or off with the CLONE procedure,
  548.           using the "C" toggle will cause PAL to  temporarily switch to
  549.           the opposite state.  
  550.  
  551.                FILE HANDLING:
  552.  
  553.                You  can  change  the  name  that  PAL  assumes  for the
  554.           appointment file that you  wish to  search, and  you can tell
  555.           PAL  what  directories  to  look in for the appointment file.
  556.           You can also change the name of the  file that  PAL writes to
  557.           when you use the "F" switch in Report Mode or Search Mode.  
  558.  
  559.                PRINTER:
  560.  
  561.                You can  specify special  printer codes  to send to your
  562.           printer before and after a report.  You can change the number
  563.           of lines printed per page or provide for continuous printing.
  564.           You may wish  to  combine  a  number  of  printer  changes to
  565.           provide for printing in very compressed type (if your printer
  566.           allows it) so that  a  long  report  could  fit  on  a single
  567.           printed page.
  568.  
  569.  
  570.  
  571.  
  572.  
  573.  
  574.  
  575.           Intro to PAL and PALARM/PALSET                     --  15  --
  576.  
  577.  
  578.                COMMAND LINE ACTION:
  579.  
  580.                You can  even tell  PAL an action that you would like it
  581.           to take every time  it is  called without  additional command
  582.           line parameters.   The  distribution version of PAL automati-
  583.           cally calls up the  opening  menu  if  all  you  type  at the
  584.           command line is "PAL".  Instead of summoning the opening menu
  585.           with the simple "PAL" command, you  can instruct  PAL to take
  586.           any  other  action  that  would  have been permitted from the
  587.           command line.  For instance, if you commonly use PAL  to send
  588.           a 90  day report  to your  printer, you can tell PAL that the
  589.           assumed command will be "PAL 90p"; thereafter, every time you
  590.           invoke PAL  without additional  parameters, it will produce a
  591.           90-day report.  You can always  override the  assumed command
  592.           with explicit command line parameters.
  593.  
  594.                CREATING NEW COM FILES:
  595.  
  596.                When you  have finished  making changes to PAL's assump-
  597.           tions, you can then have PAL produce a new .COM file.  Unless
  598.           you specify  otherwise, the  name of  the first new .COM file
  599.           created from the distribution version will be PAL15.COM.  The
  600.           assumed name  for subsequent cloned versions will be whatever
  601.           name you selected  for  the  .COM  file  from  which  you are
  602.           presently cloning.   You may find it useful to clone a series
  603.           of .COM  files  with  different  names,  each  one containing
  604.           different assumptions.
  605.  
  606.                RESTORING DISTRIBUTION DEFAULTS:
  607.  
  608.                If after  cloning new  versions of PAL, you would like a
  609.           simple method of restoring the original assumptions contained
  610.           within  the  distribution  version  of  PAL, simply issue the
  611.           command "PAL RESTORE" from the DOS prompt.
  612.  
  613.  
  614.  
  615.  
  616.  
  617.           Intro to PAL and PALARM/PALSET                     --  16  --
  618.  
  619.  
  620.           Alarms:  Using PALARM and PALSET
  621.  
  622.                PALARM allows your computer to maintain up to  10 alarms
  623.           at any  time.   When the  moment comes  for the alarm, PALARM
  624.           will pop up over  your current  application and  will present
  625.           you with both a visual and an audible alarm (the visual alarm
  626.           will not pop up over a graphics application).  
  627.  
  628.                KILLING AND SNOOZING:
  629.  
  630.                You kill the alarm by hitting  the carriage  return key.
  631.           If you fail to kill the alarm within a specified period, then
  632.           PALARM will automatically silence  the  alarm,  snooze  for a
  633.           period, then pop up again later.  You can intentionally force
  634.           PALARM to snooze by hitting any  key other  than the carriage
  635.           return.   If PALARM  is snoozing,  you will  hear a soft tick
  636.           sound approximately once per second.
  637.  
  638.                CHANGING SNOOZE PERIODS:
  639.            
  640.                As distributed,  the alarm  will display  for 10 seconds
  641.           and will  snooze for  1 minute.   With PALSET, you can change
  642.           the time for display  to between  1 and  60 seconds,  and the
  643.           snooze time  to between  1 minute  and 24 hours.  This change
  644.           can be made by  entering the  Install function  from PALSET's
  645.           main menu.
  646.  
  647.                CHANGING SOUND LEVEL:
  648.  
  649.                An  additional  control  you  have over the alarm is the
  650.           ability to specify the type of sound you hear when  the alarm
  651.           goes off.   You  can change  the sound to OFF, LOW, NORMAL or
  652.           HIGH.  The distribution version of  PALARM has  the sound set
  653.           to LOW.
  654.  
  655.                CHANGING TIME AND DATE DISPLAY:
  656.  
  657.                When you first install PALARM, you will see the date and
  658.           time at the upper right hand corner of your display.   If you
  659.           prefer not  to have  the clock  and date  display, then enter
  660.           PALSET and turn  either  or  both  off  temporarily  with the
  661.           toggle options  on the  opening menu,  or turn either or both
  662.  
  663.  
  664.  
  665.  
  666.  
  667.           Intro to PAL and PALARM/PALSET                     --  17  --
  668.  
  669.  
  670.           off  permanently  by  entering  the  installation  option  on
  671.           PALSET's opening menu.
  672.  
  673.                EDITING ALARMS WITH PALSET:
  674.  
  675.                Editing alarms  is accomplished  by entering the "Alarms
  676.           Menu".   You  can  add  alarms,  edit  them,  delete specific
  677.           alarms, purge old alarms, or clear the entire alarm sequence.
  678.           When you exit the  Alarms menu  and get  back to  the opening
  679.           PALSET menu,  you should "S"ave your changes to the data file
  680.           if you want the information remembered the next time you boot
  681.           up.  If you fail to "S"ave the information, then your changes
  682.           will be remembered only  for your  current computing session.
  683.           If, prior  to saving  the current  changes, you would like to
  684.           restore the information which  was last  saved to  disk, then
  685.           use the "L"oad option from PALSET's main menu.
  686.  
  687.                While  you  are  editing,  the  information currently in
  688.           memory will automatically be stored to disk when  you kill an
  689.           alarm.   Therefore, if  an alarm  pops up in the middle of an
  690.           editing session and you're not sure that you want the current
  691.           changes  to  overwrite  your  existing  data, then instead of
  692.           killing the alarm, force it to snooze.  When you  are certain
  693.           that your  editing changes are correct, you can then kill the
  694.           alarm the next time it pops up.
  695.  
  696.                REMOVING PALARM:
  697.  
  698.                To remove PALARM  from  memory,  first  satisfy yourself
  699.           that no  other application  is currently  running (You are at
  700.           the DOS command line)  and that  no other  programs reside in
  701.           memory after  PALARM (e.g., you either did not load SideKick,
  702.           or,  having  done  so,  have  already  removed  SideKick from
  703.           memory).   Then, if  you still wish to remove PALARM, hit the
  704.           ALT key, then (still holding  the  ALT  key)  press  the LEFT
  705.           SHIFT key.   PALARM  will then permit you the final choice of
  706.           answering "Y" or "N" to  the  question  whether  you  wish to
  707.           proceed in killing the program.  
  708.  
  709.  
  710.  
  711.  
  712.  
  713.  
  714.           Intro to PAL and PALARM/PALSET                     --  18  --
  715.  
  716.  
  717.                CUSTOMIZING THE HOT KEY:
  718.  
  719.                If  you  find  that  the ALT/LEFT-SHIFT combination con-
  720.           flicts with key combinations used by other resident programs,
  721.           you may  patch PALARM  for the  appropriate scan code of your
  722.           choice.  For this, you must  be  familiar  with  DEBUG.   Use
  723.           debug to search through PALARM.COM for the character sequence
  724.           "SCAN".  The byte  immediately  thereafter  will  contain the
  725.           scan code  of the  key to be used in conjunction with the ALT
  726.           key.  The distribution version of  PALARM will  show the byte
  727.           "2A", signifying  the LEFT-SHIFT  key.  A table of scan codes
  728.           follows this paragraph.  Edit that single byte to contain the
  729.           scan code  of your  choice, then  write the  file back to the
  730.           disk and quit  DEBUG.    PALARM's  ability  to  dismount from
  731.           memory will  then function  with your  new scan code combina-
  732.           tion.  Be careful  with this,  for the  initial response that
  733.           PALARM gives  when loaded  will still say that ALT/LEFT-SHIFT
  734.           will allow removal from memory, even though you  have changed
  735.           it to another key combination.
  736.  
  737.  
  738.  
  739.  
  740.  
  741.  
  742.           Intro to PAL and PALARM/PALSET                     --  19  --
  743.  
  744.  
  745.                SCAN CODE TABLE:
  746.  
  747.                Following is  a table  of keys and their associated scan
  748.           codes which should be  entered with  DEBUG to  produce an ALT
  749.           combination:
  750.  
  751.                Key  Code      Key  Code      Key  Code      Key  Code
  752.                A    1E        B    30        C    2E        D    20
  753.                E    12        F    21        G    22        H    23
  754.                I    17        J    24        K    25        L    26
  755.                M    32        N    31        O    18        P    19
  756.                Q    10        R    13        S    1F        T    14
  757.                U    16        V    2F        W    11        X    2D
  758.                Y    15        Z    2C        ESC  01        1/!  78
  759.                2/@  79        3/#  7A        4/$  7B        5/%  7C
  760.                6/^  7D        7/&  7E        8/*  7F        9/(  80
  761.                0/)  81        -/_  82        =/+  83        BS   0E
  762.                TAB  0F        [/{  1A        ]/}  1B        CR   1D
  763.                CTRL 1D        ;/:  27        '/"  28        `/~  29
  764.                LSHT 2A        RSHT 36        \/|  2B        ,/<  33
  765.                ./>  34        //?  35        */PT 37        SPC  20
  766.                CAPS 3A        NUM  45        SCRL 46        F1   68
  767.                F2   69        F3   6A        F4   6B        F5   6C
  768.                F6   6D        F7   6E        F8   6F        F9   70
  769.                F10  71        HOME 47        END  4F        PGUP 49
  770.                PGDN 51        UP   48        DOWN 50        RGHT 4D
  771.                LEFT 4B        INS  52        DEL  53        5*   4C
  772.  
  773.           *  This refers to the 5 on the numeric keypad only.
  774.  
  775.  
  776.  
  777.  
  778.  
  779.  
  780.           Intro to PAL and PALARM/PALSET                     --  20  --
  781.  
  782.  
  783.           Infinite Alarms with SideKick
  784.  
  785.                You  now  have  the  capability  of  having  a virtually
  786.           unlimited number of alarms set  within  your  computer.   The
  787.           combination of  SideKick, PAL and PALARM permits you to enter
  788.           an alarm with SideKick, then read it with PAL, then nudge you
  789.           with  PALARM.    You  can  enter  as many alarms as you like,
  790.           limited only by your disk space.
  791.  
  792.                CREATING ALARMS WITH SK:
  793.  
  794.                To create an alarm with SideKick, all you need to  do is
  795.           make sure  that the memo that you enter has the "@" character
  796.           included.  Think of the "@" character as the word  "at".  The
  797.           alarms will sound on the day and time that you have specified
  798.           with SideKick.  The title line  in SideKick's  entry pad will
  799.           be interpreted as 7:30 a.m.
  800.  
  801.                ADVANCE ALARMS:
  802.  
  803.                You may optionally set the alarm to pop up in advance of
  804.           SideKick's time slot, so  that  you  are  no  longer entirely
  805.           bound by  SideKick's half  hour straightjacket.   In order to
  806.           request an advance alarm, all you  need to  do is immediately
  807.           follow the  "@" character  with a  number from  1 to 240.  Be
  808.           sure not to use any intervening spaces, or else PAL will fail
  809.           to interpret  the memo as requesting an advance notice alarm.
  810.           Whatever number you enter  following the  "@" will  result in
  811.           advance notice of that number of minutes.
  812.  
  813.                For instance, the following are valid alarm memos:
  814.  
  815.                     Bill Cosby show on now @
  816.                     @20 Haircut appt. uptown
  817.                     @@@@@@  WAKE  UP  @@@@@@@
  818.                     Flight to London @ 180
  819.  
  820.           Please note  that last example carefully.  It will definitely
  821.           pop up  at the  time slot  in which  it was  entered, but you
  822.           won't  get  3  hours  advance  notice, since there is a space
  823.           intervening between the "@" and the "180".
  824.  
  825.  
  826.  
  827.  
  828.  
  829.  
  830.           Intro to PAL and PALARM/PALSET                     --  21  --
  831.  
  832.  
  833.                RUN PAL TO UPDATE ALARMS!
  834.  
  835.                Last important note:  The alarms which you  have entered
  836.           with SideKick  don't get interpreted by PALARM automatically.
  837.           You need to run PAL in Report Mode to do  that.  Periodically
  838.           running  PAL  to  ask  for  a report will make sure that your
  839.           alarms are  updated  regularly.    If  you  run  PAL  in your
  840.           AUTOEXEC.BAT file every morning when you boot up, then you're
  841.           likely to do just  fine.   Since PALARM  has only  a 10 alarm
  842.           capacity, if you set more than 10 alarms during a day, you'll
  843.           have to run PAL more frequently than once daily.
  844.  
  845.                MANUAL SETTING VS. AUTOMATIC SETTING:
  846.  
  847.                In addition to the automatic setting of alarms  with the
  848.           SK/PAL/PALARM combination, you may manually set an alarm with
  849.           PALSET.  See the discussion of  PALSET  above.    If  you are
  850.           setting  alarms  through  both  the  manual and the automatic
  851.           method, be aware that the automatic  method will  take prece-
  852.           dence in  the event  of a space conflict.  That is, given the
  853.           maximum of 10 alarms in memory  at a  time, there  may come a
  854.           situation where  you have  a full register of 10 alarms, with
  855.           the 10th having been set by  PALSET.   Suppose that  the next
  856.           time PAL  examines your  appointment file  it finds 10 alarms
  857.           which are earlier in time than the one  you had  manually set
  858.           with  PALSET;  that  manually  created  alarm will have to be
  859.           bumped out of memory in order to make room for the 10 earlier
  860.           automatic alarms.   Once  bumped out  of memory, the manually
  861.           entered alarm  will be  lost unless  you enter  it once again
  862.           manually,  since  there  is  no physical record of that alarm
  863.           anymore.  On the  other  hand,  if  SK/PAL  enters  10 alarms
  864.           automatically, and  you then  enter an earlier alarm manually
  865.           with PALSET, the automatic alarm which must be  bumped out of
  866.           the register  will still be in your SideKick appointment file
  867.           and will be loaded in the  future  the  next  time  PAL finds
  868.           sufficient room in the register.
  869.  
  870.  
  871.  
  872.  
  873.  
  874.  
  875.           Intro to PAL and PALARM/PALSET                     --  22  --
  876.  
  877.  
  878.                SHAREWARE LIMITATION:
  879.  
  880.                The ability  to have  infinite alarms  set with SideKick
  881.           has been limited in  this  shareware  version.    After June,
  882.           1987, this feature will no longer operate.  We hope that this
  883.           extended demonstration period will encourage you  to purchase
  884.           the  commercial  versions  from  us.    See the section below
  885.           entitled "Commercial PAL" for ordering information.
  886.  
  887.  
  888.  
  889.           TSR Wars; Multitasking
  890.  
  891.                Resident programs are often referred to  as TSR's, after
  892.           the  DOS  programmer's  function  that  permits  a program to
  893.           Terminate but Stay  Resident.    As  more  and  more resident
  894.           programs vie  for memory,  processor time  and control, it is
  895.           inevitable that skirmishes may result, sometimes resulting in
  896.           total system lockup which can only be remedied by turning the
  897.           system off and then back on again.
  898.  
  899.                PALARM has been tested in many system configurations and
  900.           has been  found to coexist peacefully in the vast majority of
  901.           situations.  If, for any reason, you find  that the introduc-
  902.           tion of  PALARM as  a resident  program in your system causes
  903.           any problems, then first try to rearrange the  order in which
  904.           your TSR's  are loaded.   In  most cases,  you will find that
  905.           loading PALARM early on in  the  sequence  should  solve your
  906.           problem.   You should  also make  sure that  SideKick is your
  907.           last-loaded resident program.  If you  still have  a problem,
  908.           you  might  want  to  try  toggling the "Desqview" option de-
  909.           scribed in the next paragraph.   Lastly, for  advanced users,
  910.           PAL, PALARM and PALSET communicate through user interrupts 6F
  911.           and 7F;  if you  find  that  these  interrupts  conflict with
  912.           other programs,  just call us and we'll give you a method for
  913.           getting around the conflict.
  914.  
  915.                Multitasking  software,  such  as   DoubleDos,  Windows,
  916.           Desqview, TopView, Windows and TaskView are essentially TSR's
  917.           which spawn several application programs as  child processes.
  918.           PALARM  is  a  mini-multitasker  itself,  because it steals a
  919.           little bit  of processor  time to  keep track  of when alarms
  920.  
  921.  
  922.  
  923.  
  924.  
  925.           Intro to PAL and PALARM/PALSET                     --  23  --
  926.  
  927.  
  928.           must be  sounded.   The only  multi-tasking system with which
  929.           PALARM has been extensively tested is Desqview, and  you must
  930.           make  a  special  adjustment  in  order  for  the two to work
  931.           together.  If you fail to make this adjustment, then you will
  932.           experience  system  lockups.    With  PALARM  loaded, call up
  933.           PALSET and hit "I" to enter installation mode.  Answer "Y" to
  934.           PALSET's prompt  asking whether  you want to change anything,
  935.           then continue  responding to  PALSET's prompts  until it asks
  936.           you about  the Desqview  option.  Answer "Y" in order to turn
  937.           the Desqview option  on,  then  allow  PALSET  to  proceed to
  938.           install the  new version.   The  change you  have made to the
  939.           Desqview toggle will not take effect until the  next time you
  940.           load  PALARM,  but  any  other  changes  you have made in the
  941.           install procedure will take effect immediately.
  942.  
  943.                If you have any problems running PALARM, we want to hear
  944.           about it.  If we don't know about it, we can't fix it.
  945.  
  946.  
  947.  
  948.  
  949.  
  950.  
  951.  
  952.  
  953.           Intro to PAL and PALARM/PALSET                     --  24  --
  954.  
  955.  
  956.           Support (Both Ways)
  957.  
  958.                FOR YOU:
  959.  
  960.                Remember  that  both  PAL  and  PALSET have online help.
  961.           Either can  be  accessed  from  the  program's  opening menu.
  962.           PAL's online  help can  also be  reached by using the command
  963.           "PAL HELP" from the command line.
  964.  
  965.                For support, comments and questions, we are available by
  966.           voice at  (212) 334-9172  or on  our Bulletin Board System at
  967.           (212) 334-9171.  You may also write to  us at  the address on
  968.           the title  page of this introduction, or communicate by modem
  969.           by means of Compuserve (ID #70475,1071).  On  Compuserve, you
  970.           can either  use EMAIL  or flag us down on the Borland SIG (GO
  971.           BORAPP) or the IBM Software SIG (GO IBMSW).  
  972.  
  973.                FROM YOU:
  974.  
  975.                These programs are not  intended to  be free.   They are
  976.           presented for  your review  on a consignment basis.  They are
  977.           "shareware", which means that  if you  find them  of use, you
  978.           are obliged  to pay for them.  We suggest a shareware contri-
  979.           bution of $25 for PAL and $15 for  PALARM/PALSET, or  $30 for
  980.           the combination.
  981.  
  982.                Registration is  simple.  Just enter the "HELP" function
  983.           of PAL from the main menu or from  the command  line.  Select
  984.           the "Registration" section, and you're on your way.
  985.  
  986.           Commercial PAL
  987.  
  988.                The  shareware  versions  of PAL and PALARM/PALSET which
  989.           you are  sampling  essentially  identical  to  the commercial
  990.           versions, with  one major  exception.  The ability to have an
  991.           infinite number of alarms set  with  SideKick  is  limited in
  992.           time.  After June, 1987, that feature will no longer operate.
  993.  
  994.                We encourage  you to  order the commercial versions from
  995.           us, which will always have the  infinite alarm  feature.  And
  996.           who knows what other goodies might be implemented by the time
  997.           you get around to ordering?
  998.  
  999.  
  1000.  
  1001.  
  1002.  
  1003.           Intro to PAL and PALARM/PALSET                     --  25  --
  1004.  
  1005.  
  1006.  
  1007.                To  order  the  commercial  versions,  just  enter PAL's
  1008.           online  help  function  and enter the "Registration" section.
  1009.           Print out the order form and send in  your check  for $49.95.
  1010.           Or if  you prefer  using your credit card, call our toll free
  1011.           numbers at 800-541-0900 throughout the United  States, except
  1012.           in California where the number is 800-334-3030.  You may also
  1013.           call our voice line at 212-334-9172 to place a C.O.D. order.
  1014.  
  1015.  
  1016.  
  1017.           Legal Stuff:  Warranties and Limitations
  1018.  
  1019.                Our lawyer says we have to  write this  stuff here.   It
  1020.           just so  happens that the author of PAL and the sole proprie-
  1021.           tor of PAL Software NY is a lawyer.
  1022.  
  1023.                PAL, PALARM and PALSET (the "Licensed Programs") are the
  1024.           exclusive property  of PAL Software NY (the "Licensor").  You
  1025.           are granted a limited  license to  try the  Licensed Programs
  1026.           for a  reasonable period of time for you to determine whether
  1027.           they are useful for you.  If you find them of use, please pay
  1028.           for them.   We  suggest a contribution of $25 for PAL and $15
  1029.           for PALARM/PALSET, or $30 for the combination.  
  1030.  
  1031.                You are  granted  permission  to  freely  distribute the
  1032.           Licensed Programs in their original form, without alteration,
  1033.           so long as this documentation is  distributed along  with the
  1034.           Licensed  Programs.    We  suggest that you distribute in the
  1035.           original ARChived format.   No person  may charge  any monies
  1036.           for  the  distribution  of  the  Licensed  Programs  except a
  1037.           reasonable fee for media and shipping  costs.   No person may
  1038.           distribute the  Licensed Programs in connection with the sale
  1039.           or distribution of any other product  for profit,  whether or
  1040.           not a separate charge is made for the Licensed Programs. 
  1041.  
  1042.                The  Licensor  represents  that  many users have enjoyed
  1043.           using PAL and certainly hopes that  you will,  too.  However,
  1044.           the Licensor  DOES NOT WARRANT THAT THE LICENSED PROGRAMS ARE
  1045.           FIT FOR ANY PARTICULAR USE OR ARE MERCHANTABLE.  THE LICENSED
  1046.           PROGRAMS ARE  NOT WARRANTED  TO BE FREE OF BUGS, NOR ARE THEY
  1047.           PROVIDED WITH ANY WARRANTY OF ANY  KIND, EITHER  EXPRESSED OR
  1048.  
  1049.  
  1050.  
  1051.  
  1052.  
  1053.           Intro to PAL and PALARM/PALSET                     --  26  --
  1054.  
  1055.  
  1056.           IMPLIED.   IT IS YOUR RESPONSIBILITY TO DETERMINE WHETHER THE
  1057.           LICENSED PROGRAMS ARE SUITABLE  FOR YOU.   IN  NO EVENT SHALL
  1058.           THE LICENSOR,  ITS OWNERS  OR AGENTS  BE HELD RESPONSIBLE FOR
  1059.           INCIDENTAL, SPECIAL OR CONSEQUENTIAL DAMAGES, OR LOST DATA OR
  1060.           PROFITS TO  ANY PERSON   OR  ENTITY THAT MAY ARISE OUT OF THE
  1061.           USE OF THE LICENSED PROGRAMS, EVEN IF THE POSSIBILITY OF SUCH
  1062.           DAMAGE HAS BEEN BROUGHT TO THE ATTENTION OF THE LICENSOR.
  1063.  
  1064.  
  1065.